glGetTexGendv,
glGetTexGenfv, glGetTexGeniv
[New
- Windows 95, OEM Service Release 2]
These
functions return texture coordinate generation parameters.
void glGetTexGendv(
|
GLenum coord, |
|
|
GLenum pname, |
|
|
GLdouble * params |
|
|
); |
|
void glGetTexGenfv(
|
GLenum coord, |
|
|
GLenum pname, |
|
|
GLfloat * params |
|
|
); |
|
void glGetTexGeniv(
|
GLenum coord, |
|
|
GLenum pname, |
|
|
GLint * params |
|
|
); |
|
Parameters
coord
A texture
coordinate. Must be GL_S, GL_T, GL_R, or GL_Q.
pname
The symbolic
name of the value(s) to be returned. Must be either GL_TEXTURE_GEN_MODE or the
name of one of the texture generation plane equations: GL_OBJECT_PLANE or
GL_EYE_PLANE. These values are as follows:
GL_TEXTURE_GEN_MODE
The params
parameter returns the single-valued texture-generation function, a symbolic
constant.
GL_OBJECT_PLANE
The params
parameter returns the four plane equation coefficients that specify object
linear-coordinate generation. Integer values, when requested, are mapped
directly from the internal floating-point representation.
GL_EYE_PLANE
The params
parameter returns the four plane equation coefficients that specify eye
linear-coordinate generation. Integer values, when requested, are mapped
directly from the internal floating-point representation. The returned values
are those maintained in eye coordinates. They are not equal to the values
specified using glTexGen,
unless the modelview matrix was identified at the time glTexGen was
called.
params
Returns the
requested data.
Remarks
The glGetTexGen
function returns in params selected parameters of a texture-coordinate
generation function that you specified with glTexGen. The coord
parameter names one of the (s,t,r,q) texture
coordinates, using the symbolic constant GL_S, GL_T, GL_R, or GL_Q.
If an error
is generated, no change is made to the contents of params.
Error Codes
The following
are the error codes generated and their conditions.
|
Error
Code |
Condition |
|
GL_INVALID_ENUM
|
coord or pname was not an accepted value. |
|
GL_INVALID_OPERATION
|
glGetTexGen was called between a call to glBegin and the
corresponding call to glEnd. |
See Also